/*******************************************************************************
 * Owlets Framework
 * Copyright 2011 Logicfish Software http://logicfishsoftware.com/
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License
 * 
 * @author logicfish@gmail.com
 *
 ******************************************************************************/

package com.logicfishsoftware.owlet.app;


/**
 * 
 * Basic function.  Classes would override with the methods they need. The {@link #proceed()} method is to be invoked after
 * the operator has completed, and resources have been released.  The operator returned by {@link #proceed()} will be invoked
 * after the resource containing the original operator has been released.
 * 
 *  Example:
 *  
 *  Operator<X> invoke(Operator<X> op) {
 *    op.doSomething(..);
 *    return op.proceed();
 *  }
 *  
 *  Operator<X> x;
 *  do x = invoke(x).proceed() while(x);
 * 
 * @author logicfish@gmail.com
 *
 */
public interface Operator<U> {
	/**
	 * @return 
	 * @throws ApplicationException 
	 * 
	 */
	Operator<U> proceed() throws ApplicationException;

}
